Editing the UDF

Add/Remove connectors

You can create an input/output by dragging a connection line from a block to the left or right side of the UDF edit rectangle area.

To remove an input/output, select the yellow connector figure and select "Delete" in context menu. The related connection line(s) will be deleted as well.

Configure UDF properties

UDF properties include information such as identifier, password, connector names, parameters, comments and so on. To edit the UDF properties, double-click the identifier text above the UDF edit box or use menu command "Edit -> Edit UDF Properties". LOGO!Soft Comfort displays the "Edit UDF properties" dialog ("Demo" in this example).

The "Edit UDF properties" dialog includes three tabs:

The "I/O" tab

From the "I/O" tab, you can configure the identifier, the UDF password, and the names of input connectors and output connectors.

In the "Identifier" field, you can enter an identifier for your UDF. The identifier is "UDF" by default.

UDF password offers the capability to hide the details of a UDF such that a UDF library can be distributed without the details. In the use mode, you can right-click the UDF, and select "Expand UDF" in the context menu list to expand the UDF and view its details.

If you did not configure a password for the UDF, it will expand in the UDF and display its contents when you select "Expand UDF":

If you have configured a password to protect the UDF, you must first enter the password after you select "Expand UDF". After entering the correct password, LOGO!Soft Comfort expands the UDF and displays its contents:

The "Parameters" tab

In the "Parameters" tab, you can configure the parameters of the UDF.

You can reference the available parameters of the function blocks used in the UDF as the parameters of the UDF. The "Block" list shows the function blocks, while the "Parameter" list shows the parameters that the selected block includes. Double-click a parameter or use the "Add" button to add a parameter from the "Parameter" list to "Parameter Reference" table:

To remove a parameter from the "Parameter Reference" table, select the parameter and click the "Remove" button. The parameter then re-appears in the "Parameter" list:

Use the "Identifier" column of the "Parameter Reference" table to identify each parameter. Use a unique identifier for each parameter.

The "Comment" tab

You can use the "Comment" tab to add an description to your UDF.

The comment can describe how to use the UDF, the function of the inputs and outputs, and any other details. By default, the comment appears to the right of the UDF edit box, but you can place it wherever you choose.

UDF Identifier

The UDF identifier appears on the UDF edit box as an easy, short identifier of the UDF, and also appears in the block tree.

As shown below, you configure the UDF identifier in the "I/O" tab of the "Edit UDF properties" dialog. It is limited to eight characters with a default name of "UDF".

User-defined name for a UDF

You can also configure a user-defined name for a UDF. It is the block name of the UDF as other Function Blocks in a circuit program.

To configure a user-defined name for the UDF, double-click the UDF block:

Enter a name for the UDF, and click "OK":